home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / os2tools / av_133 / av.hlp (.txt) < prev    next >
OS/2 Help File  |  1992-09-19  |  31KB  |  799 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Select File ΓòÉΓòÉΓòÉ
  3.  
  4. A filename may be entered directly into the Filename entry field, or you may 
  5. select a file from the Files listbox.  A listbox is also provided for 
  6. Directories, and a drop-down box for Drives, to allow you to move freely around 
  7. your file system. 
  8.  
  9. Once a filename is entered (or selected by double click, or highlighting and 
  10. pressing the Okay button), AV attempts to determine whether or not the file is 
  11. an archive.  If it seems to be, it attempts to get a listing of files in the 
  12. archive, with the aid of the configured archiver.  If the list attempt 
  13. succeeds, you get the second major dialog box, Archive Contents.  If the file 
  14. does not appear to be an archive, or if the list attempt fails, the software 
  15. you have specified under Viewer in Configuration is called to let you view the 
  16. file (or a cheap internal viewer is used if you haven't configured AV), unless 
  17. the file is an executable program and you have AV in Launcher mode, in which 
  18. case it is run.  These default operations may be overridden by selecting 
  19. (highlighting) a file and choosing a different action from the dialog box 
  20. control labeled "Menu."  (Note:  When the Menu, or any other dropdown combobox, 
  21. is active, F4 will cause it to drop down if you have no mouse). 
  22.  
  23. (Most of the time, using AV consists of selecting one or more things,  then 
  24. choosing something to do with your selection.) 
  25.  
  26. There are a few options under the Menu control that don't apply to selected 
  27. files.  Assoc calls up AV's Associations dialog.  Groups calls up AV's Group 
  28. Manager.  CMD calls up a copy of CMD.EXE for you; a shortcut.  Mass calls up 
  29. the Mass File Maintenance dialog, and Rescan rescans the current directory, 
  30. handy for when you've changed diskettes or another process has diddled with the 
  31. files in the current directory.  Defaults restores AV's saved defaults if 
  32. you've made temporary changes.  EditArc lets you edit archiver details 
  33. directly, and AddArc lets you add an archiver type in the same manner. 
  34.  
  35. To exit AV, click the Exit button on the AV: Select (Master) Select File dialog 
  36. (the dialog that normally comes up first when you start AV). When AV is not in 
  37. Launcher mode, pressing the ESCape key while that dialog is active will also 
  38. exit AV. 
  39.  
  40. Note that when AV is used as a replacement Workplace Shell, the Exit button on 
  41. the Master Select File window reads "Shut" for Shutdown. 
  42.  
  43. See also: 
  44.  
  45. Archive Contents 
  46. Configuration 
  47. Associations 
  48. Build Archive 
  49. Copy/Move files 
  50. Mass File Maintenance 
  51. Group Manager 
  52. Registration 
  53. Installing AV 
  54. Filemasks 
  55. Replacing the Workplace 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 1.1. Associations ΓòÉΓòÉΓòÉ
  59.  
  60. The Associations dialog lets you associate a filemask (like *.dwg) with a 
  61. particular program.  Then, when AV is in Launcher mode, if you enter or 
  62. double-click on a filename that matches the mask, the program is run with the 
  63. datafile as part of its argument string (in our *.dwg example, it might start 
  64. AutoCAD to edit or plot the drawing).  Other examples might be associating 
  65. *.mak files with a compiler make utility and *.c files with a text editor. 
  66.  
  67. You can Clone AV to "tear off" a Select File window.  You might leave this 
  68. cloned window "looking into" a particular directory filled with datafiles, and 
  69. use it to launch an application on selected files as needed. 
  70.  
  71. The Associations dialog is reached via the Assoc item under Select File's Menu 
  72. control. 
  73.  
  74. In the Run entry box you can use the special symbol "%*" to mean "place the 
  75. selected filename here."  Otherwise, AV concats a space and then the filename 
  76. to the string you enter in the Run field.  The special symbol "%!" can be used 
  77. to insert the full directory path where the selected filename resides. 
  78.  
  79. See also: 
  80.  
  81. Select File 
  82. Mass Copy/Move 
  83.  
  84.  
  85. ΓòÉΓòÉΓòÉ 1.2. Build Archive ΓòÉΓòÉΓòÉ
  86.  
  87. The Build Archive dialog lets you create a new archive (or update an old 
  88. archive).  When you select Build from Select File's Menu control, you'll be 
  89. presented with a dialog box that let's you select files to include in the new 
  90. archive.  You can also enter a name for the archive in the entry field toward 
  91. the top of the screen (or change a name that's already there; if a file was 
  92. selected in Select File, its name is copied to the entry field assuming that 
  93. it's an old archive to be updated). 
  94.  
  95. You can check the Move to Archive box if you want the original files erased 
  96. after being placed into the archive.  Check the Include Directories box if you 
  97. want to include directory pathnames in the archive (the selected archiver must 
  98. be capable of this, and ARCHIVER.BB2 must have the proper control string in it 
  99. [Note: in this version of AV it really doesn't matter; Include Directories 
  100. isn't implemented yet]). 
  101.  
  102. If you're using a mouse, single-click a filename to highlight it.  Click again 
  103. to unhighlight.  If you're using the keyboard, the spacebar will 
  104. highlight/unhighlight.  Once you've highlighted a few files in the Files 
  105. listbox, click the Add button.  The files are transfered to the To Archive 
  106. listbox.  If you highlight files in the To Archive listbox and click Remove, 
  107. they disappear from the To Archive listbox. 
  108.  
  109. The Drives dropdown box and Dirs listbox let you move around the file system 
  110. adding files to the To Archive listbox. 
  111.  
  112. Once you've moved all the files you want into the To Archive listbox, click 
  113. Okay. If the archive filename in the entry box has a recognizable extension 
  114. (i.e. .ARC, .LZH, .ZIP, etc.), AV proceeds to build the archive.  Otherwise 
  115. you're presented with another small dialog box that lets you select the 
  116. archiver to use. 
  117.  
  118. Once AV has an archive filename, some files to put into the archive, and an 
  119. archiver type to go by, it begins building the archive. 
  120.  
  121. Build Archive is available only in registered versions of AV. 
  122.  
  123. See also: 
  124.  
  125. Select File 
  126. Registration 
  127. Filemasks 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 1.3. Copy/Move Files ΓòÉΓòÉΓòÉ
  131.  
  132. In the Select File dialog box, highlight a file.  Then select Copy or Move from 
  133. the Menu control.  A new dialog box pops up that lets you choose a destination 
  134. path, and possibly change the filename (allowing you to rename as you move or 
  135. copy the file, or even rename without moving or copying). 
  136.  
  137. The filename is in an entry field toward the top of the dialog box, and can be 
  138. changed to allow renaming.  The original filename remains in a text box for 
  139. reference.  A new path is selected using the Drives drop-down box and the 
  140. Directories listbox.  The "current" new path is in a readonly entry field for 
  141. positive identification. 
  142.  
  143. Click Okay once you have the new path (and filename, if renaming is desired) 
  144. set.  This command copies or moves one file at a time. 
  145.  
  146. Copy and Move are available in unregistered copies of AV, but only registered 
  147. copies have Mass File Maintenance. 
  148.  
  149. See also: 
  150.  
  151. Select File 
  152. Mass File Maintenance 
  153. Registration 
  154.  
  155.  
  156. ΓòÉΓòÉΓòÉ 1.4. Mass File Maintenance ΓòÉΓòÉΓòÉ
  157.  
  158. This command moves, copies, deletes or otherwise manipulates many files at one 
  159. time. 
  160.  
  161. To use this dialog, add files from the "Files" listbox to the "To be acted 
  162. upon" listbox using the Add button -- highlight the files in the Files listbox, 
  163. then click Add.  To remove files from the "To be acted upon" listbox, highlight 
  164. them, then click the Remove button. 
  165.  
  166. When your files are selected as above, choose an action from the Copy, Delete, 
  167. Move, Command and 1Command radio buttons.  Then click Okay.  If you chose Copy 
  168. or Move, be sure to move to the directory to which you want the files copied or 
  169. moved before clicking Okay.  If you chose Command or 1Command you'll be asked 
  170. for the command to run against the files.  The command can be an intrinsic 
  171. CMD.EXE command like ERASE or a program file like TOUCH.EXE. 
  172.  
  173. AV will not prompt you on a copy or move, and will only prompt you on delete or 
  174. if the copy/move target exists if you have "Confirm" checked. You will be 
  175. notified if a copy, move or delete fails. 
  176.  
  177. Here're a couple of examples of how you might use this dialog: 
  178.  
  179. Move to a directory using the Drives and Directories controls.  Enter "*.BAK" 
  180. as the Mask.  Click on the side of the Files listbox to be sure it's active, 
  181. then click on the +All button to highlight all files in the listbox.  Now click 
  182. on the Add button to place the files in the "To be acted upon" listbox.  Click 
  183. the Delete radio button, then click the Okay button.  This action deletes all 
  184. *.BAK files in the directory. An experienced mouser can do this in about the 
  185. same time than it takes to type "DEL d:\path\*.BAK" on a command line, and you 
  186. don't have to load a command line prompt first. 
  187.  
  188. A programmer might select a group of .OBJ files and run a Touch utility on them 
  189. using Command or 1Command.  The difference between the two buttons is that 
  190. Command starts a session for each file it acts on, whereas 1Command starts one 
  191. session with all filenames listed as arguments. 
  192.  
  193. Mass File Maintenance is available only in registered copies of AV. 
  194.  
  195. See also: 
  196.  
  197. Configuration 
  198. Copy/Move Files 
  199. Registration 
  200. Select File 
  201. Filemasks 
  202.  
  203.  
  204. ΓòÉΓòÉΓòÉ 1.5. Installing AV ΓòÉΓòÉΓòÉ
  205.  
  206. Installing AV is easy: 
  207.  
  208. Copy AV.HLP to the directory named in the HELP environment variable (usually 
  209. C:\OS2\HELP). Copy ARCHIVER.BB2 to a directory listed in the PATH or DPATH 
  210. environment variables. Optionally copy AV.EXE to a directory listed in the PATH 
  211. environment variable.  This lets you execute AV from any OS/2 command line. 
  212. The ARCHIVER.BB2 file is what AV uses to know about archives.  The file is 
  213. fully commented to allow you to make changes to it.  Changes may have to be 
  214. made when you upgrade your archivers, or if you use a different archiver than 
  215. those listed in the file. 
  216.  
  217. DOS archivers will probably not work with AV.  Get OS/2 versions; they work 
  218. better anyway. 
  219.  
  220. It is possible to use the Launching portion of AV without installing 
  221. ARCHIVER.BB2.  You won't be able to view archive contents, but the rest of the 
  222. program will function normally. 
  223.  
  224. You can start AV from a command line with a filename as an argument.  AV will 
  225. attempt to view it as if it were selected.  You can start AV with a directory 
  226. name (ended with a backslash) and AV will move into that directory on startup. 
  227.  
  228. AV stores Associations in a file named AVASSOC.AV2.  By default, this file goes 
  229. in the first directory listed in DPATH.  You can copy it somewhere else on your 
  230. PATH or DPATH and AV will keep it there afterwards. AV makes a back up of this 
  231. file whenever it changes it, named AVASSOC.AVB. 
  232.  
  233. AV stores Groups in a file named AVGROUP.AV2.  Same notes apply as for 
  234. AVASSOC.AV2.  The back up file is named AVGROUP.AVB. 
  235.  
  236. AV stores other information in an .INI file named AV.INI.  This is an 
  237. OS/2-maintained file and AV does not provide a backup. 
  238.  
  239. In the event of data corruption, you can erase these files (or restore backups) 
  240. to bring AV back to its default (or saved) state. 
  241.  
  242. See also: 
  243.  
  244. Select File 
  245. Replacing the Workplace 
  246. Associations 
  247. Groups 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 1.6. Replacing the Workplace ΓòÉΓòÉΓòÉ
  251.  
  252. To install AV as a Workplace replacement: 
  253.  
  254. Follow the steps under Installing AV. Change your CONFIG.SYS file to 
  255. SET RUNWORKPLACE=<d:><\dir\>AV.EXE. 
  256. Shutdown OS/2 and reboot so the change can take effect. 
  257.  
  258. Note that if you REM out the existing SET RUNWORKPLACE line you can replace it 
  259. if AV isn't what you thought it would be.  If you have the memory to run 
  260. Workplace, I recommend you do so.  You should only consider using AV as the 
  261. Workplace if you have less than 8 megs of RAM. 
  262.  
  263. See also: 
  264.  
  265. Select File 
  266. Installing AV 
  267. Group Manager 
  268.  
  269.  
  270. ΓòÉΓòÉΓòÉ 2. Configuration ΓòÉΓòÉΓòÉ
  271.  
  272. AV's Configuration dialog lets you change the programs that you use to view and 
  273. edit files, the current file mask and the extraction directory (where files 
  274. extracted from archives are placed). 
  275.  
  276. The Viewer field is the default reader used to view files, unless you leave it 
  277. blank, in which case AV uses a cheap internal viewer (an MLE). If a file has a 
  278. special extension (i.e. .INF, .ICO, .MET, .BMP, .PKT or .GIF), a special viewer 
  279. is invoked.  The Editor field is the program used whenever you request to edit 
  280. a file.  AV attempts to use defaults for these programs that you might have 
  281. around (for instance, the default editor is E.EXE, the OS/2 System Editor), but 
  282. you can change them as you prefer (you might, for example, want to use EPM.EXE 
  283. instead of E.EXE, a much better editor that also comes with OS/2). 
  284.  
  285. Include extensions on all programs. 
  286.  
  287. There are also several checkbox toggles to alter the way AV behaves: 
  288.  
  289. Confirm View determines whether AV will check with you before displaying a file 
  290. that wasn't an archive. 
  291.  
  292. Confirm Delete determines whether AV will check with you before deleting a 
  293. file. 
  294.  
  295. Confirm Convert determines whether AV will present a warning box to you before 
  296. converting an archive from one archiver type to another. 
  297.  
  298. Show Archives Only determines whether AV will let non-archives (as determined 
  299. by file extension) show in the Select File dialog. 
  300.  
  301. Use Foreground When Possible determines whether AV runs most everything in 
  302. separate sessions or not.  At times AV can run things detached to keep the 
  303. screen uncluttered. 
  304.  
  305. Extract w/ Directories determines whether AV will try to extract directories 
  306. along with files from archives. 
  307.  
  308. Extract Follows determines whether the Extract Directory follows AV around your 
  309. file system or stays put where you started AV from (or subsequently changed it 
  310. to using this dialog box). 
  311.  
  312. Launch determines whether AV will attempt to launch files that seem to be 
  313. executable when picked in the Select File dialog. 
  314.  
  315. If StartMin is checked, AV will minimize itself if any Groups autostart. 
  316.  
  317. Save As Defaults must be checked for AV to permanently save these items into 
  318. AV.INI. Otherwise your changes are only retained for the current session.  Note 
  319. that the Extract Directory is never saved. 
  320.  
  321. See also: 
  322.  
  323. Select File 
  324. Archive Contents 
  325. Filemasks 
  326. Editting Archiver Details 
  327.  
  328.  
  329. ΓòÉΓòÉΓòÉ 3. Archive Contents ΓòÉΓòÉΓòÉ
  330.  
  331. The Archive Contents dialog box contains a listbox showing the files contained 
  332. in an archive selected at the Select File dialog.  The title bar of this dialog 
  333. box shows the archive's name.  An entry field at the top of the screen lets you 
  334. "search" the list box by entering part of a filename; the listbox attempts to 
  335. place the first matching file at the top of the listbox.  A text field at the 
  336. bottom left of the dialog box shows statistics on the archive (file size and 
  337. date), and a text field beside that counts the number of highlighted files in 
  338. the listbox. Help and Quit buttons are located at the bottom right of the 
  339. dialog. A Menu control is present at the upper right of the dialog box. 
  340.  
  341. If you highlight a file in the listbox and press [Enter] (or double-click on 
  342. it), AV temporarily extracts and views the file. Note that the listbox allows 
  343. multiple selections; only the last highlighted file is viewed.  If the file 
  344. being viewed is an archive within the archive, another Archive Contents dialog 
  345. box appears. 
  346.  
  347. You can perform other actions on files in the archive, or the archive as a 
  348. whole.  The Menu control allows you to delete files, edit a file (and 
  349. optionally refresh the archive with the editted file), convert the entire 
  350. archive to a different format, extract files, and test the entire archive.  It 
  351. also allows you to highlight, or mark, all files in the archive (deletion and 
  352. extraction require files to be highlighted), and gives you access to the 
  353. Configuration dialog box. 
  354.  
  355. See also: 
  356.  
  357. Select File 
  358. Configuration 
  359.  
  360.  
  361. ΓòÉΓòÉΓòÉ 4. Groups ΓòÉΓòÉΓòÉ
  362.  
  363. Groups are limited in unregistered copies of AV only.  They behave something 
  364. like groups in OS/2 1.x, and are intended for situations where AV displaces the 
  365. OS/2 2.0 Workplace as the primary program launcher, such as might be desired on 
  366. a low memory machine. 
  367.  
  368. The basic idea is that you create Groups containing your programs, then run 
  369. your programs from these Groups.  This lets you organize your workspace (the 
  370. desktop) and get to all related utilities simultaneously, while keeping other 
  371. Groups minimized or turned off to avoid clutter. Then, when you begin a 
  372. different job, you can switch Groups to get the proper environment for the new 
  373. job. 
  374.  
  375. For instance, you might have Groups for programming, word processing, system 
  376. utilities and games, and keep only the Group you're currently using programs 
  377. from "open," keeping the others minimized or closed. 
  378.  
  379. The Save button saves the Group's current position on the desktop. The Grp 
  380. button calls up the Group Manager.  The Help button gets you here.  The other 
  381. buttons manipulate the programs in the Group. 
  382.  
  383. See also: 
  384.  
  385. Adding/Editting Groups 
  386. Adding/Editting Programs 
  387. Group Manager 
  388. Registration 
  389. Move/Copy Between Groups 
  390.  
  391.  
  392. ΓòÉΓòÉΓòÉ 4.1. Move/Copy Between Groups ΓòÉΓòÉΓòÉ
  393.  
  394. This dialog is used to select a Group from a listbox.  The Group selected is 
  395. the Group to which you want to Move or Copy a program. 
  396.  
  397. You cannot Move/Copy a program to a Group if the Group already has a program 
  398. with the same title.  Change the title of one of the programs if there is a 
  399. conflict, then try again. 
  400.  
  401. See also: 
  402.  
  403. Group Manager 
  404. Groups 
  405. Adding/Editting Programs 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 4.2. Adding/Editting Programs ΓòÉΓòÉΓòÉ
  409.  
  410. This dialog lets you add a program to a Group.  The Title entry field is an 
  411. arbitrary name; no need to use the program's name.  The Prog field is for the 
  412. fully qualified pathname of the program (including drive and directories).  The 
  413. Path field specifies the drive and directory in which the program is started. 
  414.  
  415. The Minimize, Maximize and Fullscreen radio buttons control how an application 
  416. is started (obviously you can't minimize or maximize a fullscreen-only app, nor 
  417. run a PM app fullscreen).  The Keep checkbox determines whether a window closes 
  418. when the program terminates.  The Autostart checkbox determines whether the 
  419. application is automatically started when the Group is started.  The Prompt box 
  420. determines whether you are given an opportunity to edit the command line before 
  421. it's passed to OS/2, probably to add arguments to the program (for instance, to 
  422. add a filename to the command line that calls up a text editor). 
  423.  
  424. Double-clicking, or highlighting with the spacebar and pressing [Enter], on a 
  425. program in the listbox causes it to be executed. 
  426.  
  427. See also: 
  428.  
  429. Group Manager 
  430. Groups 
  431. Adding/Editting Groups 
  432.  
  433.  
  434. ΓòÉΓòÉΓòÉ 5. Group Manager ΓòÉΓòÉΓòÉ
  435.  
  436. The Group Manager dialog box lets you control your Groups, collections of 
  437. programs that can be launched.  These Groups are somewhat similar to the Groups 
  438. under OS/2 1.3. 
  439.  
  440. The Save button causes the position of all open Groups on the desktop to be 
  441. saved (except minimized groups).  The Help button gets you here, and the Exit 
  442. button closes the Group Manager (which may be reopened from the Select File 
  443. Menu control or any Group).  The rest of the buttons are used to manipulate 
  444. your Groups. 
  445.  
  446. An existing Group is opened by doube-clicking on its listbox title, or 
  447. highlighting the title with the spacebar and then pressing [Enter].  New Groups 
  448. start out with no program entries (naturally). 
  449.  
  450. Note that Groups are limited in unregistered copies of AV; only two Groups may 
  451. be saved, although many may be created.  You should be able to evaluate AV's 
  452. Groups with this restriction. 
  453.  
  454. See also: 
  455.  
  456. Groups 
  457. Adding/Editting Groups 
  458. Registration 
  459.  
  460.  
  461. ΓòÉΓòÉΓòÉ 5.1. Adding/Editting Groups ΓòÉΓòÉΓòÉ
  462.  
  463. Selecting Add or Edit in the Group Manager brings up this dialog box. 
  464.  
  465. To add a Group, simply enter a title.  Optionally, you can check the Autostart 
  466. or Start Minimized buttons.  Autostart Groups are opened when AV begins.  Start 
  467. Minimized Groups come up initially as icons (or in the minimized window viewer 
  468. if so configured by the OS/2 2.0 Workplace). 
  469.  
  470. See also: 
  471.  
  472. Groups 
  473. Group Manager 
  474. Adding/Editting Programs 
  475.  
  476.  
  477. ΓòÉΓòÉΓòÉ 6. Registration ΓòÉΓòÉΓòÉ
  478.  
  479. Limitations in the unregistered AV: 
  480.  
  481. Build an archive and Mass File Management are disabled. You can save only two 
  482. Groups.  You must click past an intial About box.  The limit for files within 
  483. an archive is 200 instead of 500. 
  484.  
  485. AV can be registered by private individuals by sending $25.00 US in check or 
  486. money order to: 
  487.  
  488.  
  489. Mark Kimes 
  490. 542 Merrick 
  491. Shreveport, LA  USA  71104 
  492. (318)222-3455 data 
  493. Fidonet#1:380/16 
  494.  
  495.  
  496. Registration gets you a current version of AV with all features activated, and 
  497. free upgrades for at least one year. 
  498.  
  499. To obtain the source code (for personal use only), send $50.00 US more. 
  500.  
  501. The unregistered version of AV may be used by private individuals without 
  502. charge (but you have to pay to get the registered version with its extra 
  503. features).  Obviously, AV will be improved faster and better if more people 
  504. register (because my wife won't complain so much if some money comes in :-). 
  505.  
  506. Registration is mandatory for use by businesses, governments or religious 
  507. organizations; any commercial use and/or for a profit. Commercial licenses are 
  508. $50.00 per machine (bulk rates available on request). Ask about availability of 
  509. source code for commercial sites, if interested. 
  510.  
  511. AV is copyright (c) 1992 by M. Kimes -- all rights reserved 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ 7. Editting Archiver Details ΓòÉΓòÉΓòÉ
  515.  
  516. This dialog box allows you to edit the details of an archiver. Entry boxes are 
  517. present for all the eighteen fields represented in ARCHIVER.BB2. 
  518.  
  519. In the event that you attempt to list an archive and AV feels you've probably 
  520. bungled the entry in ARCHIVER.BB2, you'll be given an opportunity to use this 
  521. dialog to fix the entry.  In this case, you'll see the listbox at the right of 
  522. the dialog filled with the listing of the archive that your archiver made.  You 
  523. can highlight a line and click the << button next to the Start List or End List 
  524. fields to move the line to that entry field (these are the most common 
  525. mistakes, and AV cannot find any files if the Start List string is wrong).  You 
  526. can double-click on a listbox line to have AV "parse" it into the Fld# text 
  527. boxes for you, to make it easier to judge field positions for sizes, dates, and 
  528. filenames.  The filename field in particular is extremely important.  If it's 
  529. too high, AV finds no files.  If it's "in range" but wrong, AV gets the wrong 
  530. fields for filenames. 
  531.  
  532. You may still need to refer to your archiver's documentation, or run it to get 
  533. the help on its command syntax.  AV can't do everything for you, but it holds 
  534. your hand as best it can. 
  535.  
  536. Refer to the ARCHIVER.BB2 file that came with AV for additional information and 
  537. an example. 
  538.  
  539. When you've completed editting the archiver's details, click Okay.  AV will ask 
  540. you if you want to rewrite ARCHIVER.BB2 (be sure you save the original copy for 
  541. its complete notes; AV will back it up one version to ARCHIVER.BAK).  If you 
  542. don't rewrite ARCHIVER.BB2, changes are good only for the current session 
  543. (handy for testing). 
  544.  
  545. You can also get to this dialog box from Select File's Menu control. 
  546.  
  547. See also: 
  548.  
  549. Archiver Details Fields 
  550.  
  551.  
  552. ΓòÉΓòÉΓòÉ 7.1. About Archiver Details Fields ΓòÉΓòÉΓòÉ
  553.  
  554. ID  This field contains an ID for the archiver; something for human 
  555. consumption.  An example might be "LHArc". 
  556.  
  557. Add  This field should contain the command that creates and adds files to an 
  558. archive.  An example might be "PKZIP.EXE -a". Note that commands should include 
  559. the extension so that AV can check them without guessing. 
  560.  
  561. Move  This field should contain the command that moves files to the archive 
  562. (adds then deletes the file).  An example might be "ARC.EXE mwn". 
  563.  
  564. Extension  This field contains the extension normally associated with files 
  565. created by this archiver.  An example might be "ZOO" for files created by the 
  566. Zoo archiver. 
  567.  
  568. Extract  This field contains the command that extracts files from the archive. 
  569. This command should not delete the files from the archive when it extracts 
  570. them, and *must* be present for AV to show you a member of the archive 
  571. (commands other than Extract and List may be left blank if necessary).  An 
  572. example might be "UNZIP.EXE -o".  Note the "-o" option given; this tells 
  573. UNZIP.EXE to automatically overwrite any existing files (AV will check to see 
  574. if any of the files exist and warn you if so).  It's important to always 
  575. include your archiver's "don't stop for user input" option; some things occur 
  576. as detached processes and you can't interact with them; the program would be 
  577. hung, which is uncool. 
  578.  
  579. Extract w/Dirs  This field contains the command that extracts files from the 
  580. archive and places them into directories embedded in the archive.  An example 
  581. might be "LH.EXE x /o /s". 
  582.  
  583. Signature  This field contains the signature for the archive type.  There is 
  584. usually a byte or few in a particular place in any archive that indicates that 
  585. it is, indeed, an archive of that type.  AV uses these signatures to "sniff 
  586. out" which archiver is used to manipulate the archive.  Since these signatures 
  587. sometimes contain characters which are "unprintable," you can use \x<hexnum> to 
  588. represent any "strange" characters. 
  589.  
  590. To determine what an archiver's signature is, either ask the archiver's author 
  591. or check several different archives of the type for one or more bytes present 
  592. in each at the same location, usually near the beginning of the file. 
  593.  
  594. This field must be entered and valid for AV to detect this type of archive (see 
  595. also Sig(nature) Pos(ition)). 
  596.  
  597. List  This field contains the command to list the archive's contents.  This 
  598. command *must* be present and correct for AV to work properly with this type of 
  599. archive.  An example might be "ZOO.EXE v". 
  600.  
  601. Test  This field contains the command to test the archive's integrity.  An 
  602. example might be "PKUNZIP.EXE -t". 
  603.  
  604. Delete  This field contains the command to delete files from the archive.  An 
  605. example might be "LH.EXE /o /d". 
  606.  
  607. Sig(nature) Pos(ition)  This field contains a number indicating how many bytes 
  608. into the file the signature is located.  If this number is negative, AV looks 
  609. from the end of the file instead of the beginning. 
  610.  
  611. F(ile)Name Pos(ition)  This field tells AV which field on the line of an 
  612. archive listing is the filename.  Fields are numbered from 0. This field must 
  613. be present and correct for AV to get the right filenames from the archive 
  614. listing. 
  615.  
  616. To understand what "field on the line of an archive listing" means, think of a 
  617. text line as being broken up into tokens, or words, separated by spaces.  These 
  618. tokens, or words, are fields.  Therefore, 
  619.  
  620. I like Ike. 
  621.  
  622. contains three fields.  Field 0 is "I", field 1 is "like", and field 3 is 
  623. "Ike." 
  624.  
  625. OldS(i)z(e) Pos(ition)  This field tells AV which field on the line of an 
  626. archive listing is the old (uncompressed) size of the file.  If this isn't 
  627. available or you don't care about it, you can enter a -1 to disable detection 
  628. of this field entirely. 
  629.  
  630. NewS(i)z(e) Pos(ition)  This field tells AV which field on the line of an 
  631. archive listing is the new (compressed) size of the file. If this isn't 
  632. available or you don't care about it, you can enter a -1 to disable detection 
  633. of this field entirely. 
  634.  
  635. Date Pos(ition)  This field tells AV which field on the line of an archive 
  636. listing is where the time/datestring is.  If this isn't available or you don't 
  637. care about it, you can enter a -1 to disable detection of this field entirely. 
  638.  
  639. NumDateF(ie)lds  This field tells AV how many fields comprise the 
  640. time/datestring. 
  641.  
  642. Here's an example of an ARC listing (5.12mpl, command "ARC l"; you may need to 
  643. widen the help windows for this to look right...): 
  644.  
  645. Name      Length   Date 
  646. ============  ========  =========   <--this line is start-of-list 
  647. MAKEFILE      374  28 Nov 89 
  648. QSORT.C      14279  29 Nov 89 
  649. QSORT.EXE     24629  29 Nov 89 
  650. STUFF.H       371  29 Nov 89 
  651.     ====  ========        <--this line is end-of-list 
  652. Total    4   39653 
  653.  
  654. Note the filename is in position 0, old length in position 1, and the date 
  655. starts in position 2, with 3 parts, and there's no new length field (so it'd be 
  656. -1).  Compare that to the archiver entry for ARC 5.12mpl in the "stock" 
  657. ARCHIVER.BB2 and you should get a feel for what all those fields mean. 
  658.  
  659.  
  660. ΓòÉΓòÉΓòÉ 8. About Filemasks ΓòÉΓòÉΓòÉ
  661.  
  662. Wildcard matching is not case-sensitive. 
  663.  
  664. If a filename does not have a period, an implicit one is automatically appended 
  665. to the end during matching operations. 
  666.  
  667. If multiple filemasks (separated by a semicolon) or a single filemask with a 
  668. trailing semicolon are used, some characters have the following special 
  669. meaning: 
  670.  
  671.  ?  A question mark matches one character, unless what it would match is a 
  672. period, slash or backslash, in which case it matches no characters. 
  673.  
  674.  *  An asterisk matches characters from the source to the target until it finds 
  675. a filename character that matches the non-wild character following it in the 
  676. filemask, or a period, slash, backslash or the end of the filename and/or 
  677. filemask. 
  678.  
  679. Therefore, "*.f?o" matches "anything.foo" but not "anything.foe". 
  680.  
  681. If only a single filemask is used, standard OS/2 wildcarding rules apply. 
  682.  
  683. Up to 24 masks may be "cascaded" by separation with semicolons. 
  684.  
  685. Masks may be saved and recalled from the listbox you'll find beside filemask 
  686. entry boxes.  To put masks into the listbox, click the Add> button beside the 
  687. listbox and the current mask will be added to the listbox.  To delete a mask, 
  688. highlight it and click the Del> button. 
  689.  
  690. To save the wildcards that are in the list, go to the Config dialog and check 
  691. "Save as Defaults," then click Okay.  The masks are automatically loaded when 
  692. AV starts, and reloaded if you select Defaults from Select File's Menu control. 
  693. The masks are saved in AV.INI. 
  694.  
  695. Note that the "Archives Only" and "EXEs Only" filters work with your filemasks; 
  696. files that get through must meet all criteria. 
  697.  
  698.  
  699. ΓòÉΓòÉΓòÉ 9. About Viewer ΓòÉΓòÉΓòÉ
  700.  
  701. Ctrl+Ins    Causes the selection region to be copied to the clipboard. 
  702.  
  703. Dn Arrow    Sets the cursor point to the closest insertion point on the 
  704. following line, then sets the anchor point to the cursor point. 
  705.  
  706. Shft+Dn Arrow Causes the cursor point to be moved to the closest insertion 
  707. point on the following line.  The anchor point does not move. 
  708.  
  709. Up Arrow    Sets the cursor point to the closest insertion point on the 
  710. preceding line, then sets the anchor point to the cursor point. 
  711.  
  712. Shft+Up    Sets the cursor point to the closest insertion point on the 
  713. preceding line. The anchor point is not moved. 
  714.  
  715. Rt Arrow    Sets the cursor point to the insertion point one character 
  716. following the cursor point.  The anchor point is set to the cursor point. 
  717.  
  718. Shft+Rt    Causes the cursor point to be set to the insertion point immediately 
  719. following the previous cursor point.  The anchor point is not moved. 
  720.  
  721. Lft and Shft+Lft Work analogously. 
  722.  
  723. Ctrl+Rt    Moves the cursor point to the insertion point immediately preceding 
  724. the next word in the text including trailing spaces, and sets the anchor point 
  725. to be equal to the cursor point. The EOL (hard line-break) and tab characters 
  726. are treated as words. 
  727.  
  728. Ctrl+Shft+Rt Moves only the cursor point in the same way as Ctrl+Rt, but leaves 
  729. the anchor point unmoved. 
  730.  
  731. Ctrl+Lft    Moves the cursor point to the preceding insertion point at the 
  732. beginning of a word, and sets the anchor point to be equal to the cursor point. 
  733. The EOL (hard line-break) and tab characters are treated as words. 
  734.  
  735. Ctrl+Shft+Lft Moves only the cursor point in the same way as Ctrl+Lft but 
  736. leaves the anchor point unmoved. 
  737.  
  738. Pgdn and Pgup  Cause the display to be scrolled one screen at a time in either 
  739. direction.  This behavior is the same as would be encountered during a pgdn or 
  740. pgup caused by the scroll-bar. 
  741.  
  742. Ctrl+Pgdn and Ctrl+Pgup Cause the display to be scrolled one screen at a time 
  743. to the right or left respectively. This behavior is the same as would be 
  744. encountered during a pgrt or pglft caused by the scroll-bar. 
  745.  
  746. Home      Sets the cursor point to the insertion point at the beginning of the 
  747. line containing the cursor point, and sets the anchor point equal to (insert 
  748. mode) or one character following (overtype mode). 
  749.  
  750. Shft+Home   Moves the cursor point to the insertion point at the beginning of 
  751. the line. The anchor point is not moved. 
  752.  
  753. End      Sets the anchor point to the insertion point at the end of the line 
  754. containing the cursor point.  If the last character on the line is a line-break 
  755. character, the anchor is positioned just before it.  The cursor is set equal to 
  756. the anchor. 
  757.  
  758. Shft+End   Moves the cursor point to the insertion point at the end of the 
  759. line, as above.  The anchor point is not moved. 
  760.  
  761. Ctrl+Home   Moves the cursor point to the insertion point at the beginning of 
  762. the document.  The anchor point is set equal to (insert mode) or one character 
  763. following it (overtype mode). 
  764.  
  765. Ctrl+End    Moves the anchor point to the insertion point at the end of the 
  766. document. The cursor point is set to be equal to the anchor point (insert mode) 
  767. or one character preceding it (overtype mode). 
  768.  
  769. Ctrl+Shft+Home Moves the cursor point in the same way as Ctrl+Home, but leaves 
  770. the anchor point unmoved. 
  771.  
  772. Ctrl+Shft+End Moves the cursor point in the same way as Ctrl+End, but leaves 
  773. the anchor point unmoved. 
  774.  
  775. Escape  Exit the viewer. 
  776.  
  777. Search functions and wrap toggle are located on the system menu, of all 
  778. places... 
  779.  
  780. Note that this is just a simple MLE viewer; you can use a better one by 
  781. entering a program in the Viewer entry field of the Config dialog. 
  782.  
  783. See also: 
  784.  
  785. Configuration 
  786.  
  787.  
  788. ΓòÉΓòÉΓòÉ 10. About Program Arguments ΓòÉΓòÉΓòÉ
  789.  
  790. Enter any arguments to the program, as you would on the command line, in the 
  791. entry box at the top of the dialog.  Then select Okay. 
  792.  
  793. Remember that when passing commands to CMD.EXE like DIR, it's "CMD.EXE /C DIR", 
  794. not just "CMD.EXE DIR". 
  795.  
  796. See also: 
  797.  
  798. START keyword 
  799. CMD.EXE usage